google 文档说明 对应地址: https://developer.android.com/studio/build

默认情况下，Android Studio 会为您希望在所有构建变体之间共享的所有内容创建 main/ 源代码集和目录。不过，您可以创建新的源代码集以精确控制 Gradle 为特定构建类型、产品变种（以及使用变种维度时的产品变种组合）和构建变体编译和打包的文件。例如，您可以在 main/ 源代码集中定义基本功能，并使用产品变种源代码集为不同客户端更改应用的品牌信息，或仅为使用“debug”构建类型的构建变体添加特殊权限和日志记录功能。

Gradle 要求您以某种类似于 main/ 源代码集的方式组织源代码集文件和目录。例如，Gradle 要求将“debug”构建类型特有的 Java 类文件放在 src/debug/java/ 目录中。

Android Plugin for Gradle 提供了一项有用的 Gradle 任务，向您展示了如何组织每个构建类型、产品变种和构建变体的文件。例如，以下任务输出示例描述了 Gradle 要求在何处能够找到“debug”构建类型的某些文件：

如需查看此输出，请按以下步骤操作：

注意：任务输出还为您展示了如何组织要用于运行应用测试的文件的源代码集，如 test/ 和 androidTest/ 测试源代码集。

java

由于“debug”构建类型被指定为目标源代码集，因此 Android Studio 会在创建 XML 文件时自动创建必要的目录。生成的目录结构应如图 2 所示

如果您的源代码未按照 Gradle 要求的默认源代码集文件结构进行组织（如上文关于创建源代码集的部分中所述），您可以使用 sourceSets 代码块更改 Gradle 为源代码集的每个组件收集文件的位置。您无需改变文件的位置，只需向 Gradle 提供相对于模块级 build.gradle 文件的路径，Gradle 应该会在该路径下找到每个源代码集组件的文件。如需了解您可以配置哪些组件，以及是否可以将它们映射到多个文件或目录，请参阅 Android Plugin for Gradle DSL 参考文档。

以下代码示例将 app/other/ 目录中的源代码映射到了 main 源代码集的某些组件，并更改了 androidTest 源代码集的根目录。

您可以让源代码集目录包含您希望只针对某些配置打包在一起的代码和资源。例如，如果您要构建“demoDebug”这个变体（“demo”产品变种和“debug”构建类型的混合产物），则 Gradle 会查看这些目录，并为它们指定以下优先级： src/demoDebug/（构建变体源代码集） src/debug/（构建类型源代码集） src/demo/（产品变种源代码集） src/main/（主源代码集）

注意：如果您将多个产品变种组合在一起，那么这些产品变种的优先级由它们所属的变种维度决定。使用 android.flavorDimensions 属性列出变种维度时，属于您列出的第一个变种维度的产品变种的优先级高于属于第二个变种维度的产品变种，依此类推。此外，您为产品变种组合创建的源代码集的优先级高于属于各个产品变种的源代码集。

上面列出的顺序决定了 Gradle 组合代码和资源时哪个源代码集的优先级更高。由于 demoDebug/ 源代码集目录很可能包含该构建变体特有的文件，因此如果 demoDebug/ 包含的某个文件在 debug/ 中也进行了定义，Gradle 会使用 demoDebug/ 源代码集中的文件。同样，Gradle 会为构建类型和产品变种源代码集中的文件指定比 main/ 中的相同文件更高的优先级。在应用以下构建规则时，Gradle 会考虑这种优先级顺序：

注意：对于给定的构建变体，如果 Gradle 遇到两个或更多个源代码集目录定义了同一个 Java 类的情况，就会抛出构建错误。例如，在构建调试 APK 时，您不能同时定义 src/debug/Utility.java 和 src/main/Utility.java。这是因为，Gradle 在构建过程中会查看这两个目录并抛出“重复类”错误。如果您希望不同的构建类型有不同版本的 Utility.java，则可以让每个构建类型定义各自的文件版本，而不是将其包含在 main/ 源代码集中。

最后，在构建 APK 时，Gradle 会为库模块依赖项随附的资源和清单指定最低优先级。

您可以为特定构建变体或测试源代码集配置依赖项，方法是在 Implementation 关键字前面加上构建变体或测试源代码集的名称作为前缀，如以下示例所示。

如需了解详情，请参阅添加构建依赖项。